home *** CD-ROM | disk | FTP | other *** search
/ Aminet 33 / Aminet 33 - October 1999.iso / Aminet / text / print / psutils.lha / psutils / README < prev    next >
Encoding:
Text File  |  1999-07-06  |  10.8 KB  |  246 lines
  1. PostScript Utilities            Angus Duggan              9th March 1997
  2.  
  3. This archive contains some utilities for manipulating PostScript documents.
  4. Page selection and rearrangement are supported, including arrangement into
  5. signatures for booklet printing, and page merging for n-up printing.
  6.  
  7. ENVIRONMENT
  8.  
  9. These utilities have been compiled and run on Sun-3 and Sun-4 machines under
  10. SunOS Solaris 2.3, Solaris 2.1, 4.1.3, 4.1.2, 4.1.1 and 4.0.1, HP9000/375
  11. machines under HPUX 7.0 and HPUX 8.0, Sequent Symmetry machines under Dynix
  12. 3.1.4 and PTX 3.2.0, IBM RS/6000, VAX/VMS, Decstation 3100 machines under
  13. Ultrix 4.0, SGI 4k5 under Irix 4.1 and 5.2, and x86 machines under MSDOS 6.0
  14. and Windows NT 3.5 and 4.0.
  15.  
  16. FILES
  17.  
  18. The files contained are:
  19. -rw-r--r--   1 angus        2317 Jun 19  1995 LICENSE
  20. -rw-r--r--   1 angus        2899 Mar 09 09:26 Makefile.bcc
  21. -rw-r--r--   1 angus        2915 Mar 09 09:26 Makefile.msc
  22. -rw-r--r--   1 angus        4135 Mar 09 09:26 Makefile.nt
  23. -rw-r--r--   1 angus        7146 Mar 09 09:26 Makefile.os2
  24. -rw-r--r--   1 angus        2895 Mar 09 09:26 Makefile.sc
  25. -rw-r--r--   1 angus        6913 Mar 09 09:26 Makefile.unix
  26. -rw-r--r--   1 angus       11345 Mar 09 09:20 README
  27. -rw-r--r--   1 angus         678 Nov 02  1995 config.h
  28. -rw-r--r--   1 angus        2373 Jun 19  1995 descrip.mms
  29. -rw-r--r--   1 angus        5773 Mar 14  1996 epsffit.c
  30. -rw-r--r--   1 angus        1291 Nov 02  1995 epsffit.man
  31. -rw-r--r--   1 angus        1236 Nov 02  1995 extractres.man
  32. -rw-r--r--   1 angus        2780 Nov 02  1995 extractres.pl
  33. -rw-r--r--   1 angus         561 Nov 02  1995 fixdlsrps.man
  34. -rw-r--r--   1 angus        1554 Nov 02  1995 fixdlsrps.pl
  35. -rw-r--r--   1 angus         527 Nov 02  1995 fixfmps.man
  36. -rw-r--r--   1 angus         556 Nov 02  1995 fixfmps.pl
  37. -rw-r--r--   1 angus         644 Nov 02  1995 fixmacps.man
  38. -rw-r--r--   1 angus        2170 Nov 02  1995 fixmacps.pl
  39. -rw-r--r--   1 angus         556 Nov 02  1995 fixpsditps.man
  40. -rw-r--r--   1 angus         655 Nov 02  1995 fixpsditps.pl
  41. -rw-r--r--   1 angus         523 Nov 02  1995 fixpspps.man
  42. -rw-r--r--   1 angus        1298 Nov 02  1995 fixpspps.pl
  43. -rw-r--r--   1 angus         531 Nov 02  1995 fixscribeps.man
  44. -rw-r--r--   1 angus         434 Nov 02  1995 fixscribeps.pl
  45. -rw-r--r--   1 angus         553 Nov 02  1995 fixtpps.man
  46. -rw-r--r--   1 angus         663 Nov 02  1995 fixtpps.pl
  47. -rw-r--r--   1 angus         547 Nov 02  1995 fixwfwps.man
  48. -rw-r--r--   1 angus         826 Nov 02  1995 fixwfwps.pl
  49. -rw-r--r--   1 angus         533 Nov 02  1995 fixwpps.man
  50. -rw-r--r--   1 angus         699 Nov 02  1995 fixwpps.pl
  51. -rw-r--r--   1 angus         531 Nov 02  1995 fixwwps.man
  52. -rw-r--r--   1 angus         383 Nov 02  1995 fixwwps.pl
  53. -rw-r--r--   1 angus         711 Apr 06  1995 getafm.man
  54. -rwxr-xr-x   1 angus        6482 Jun 19  1995 getafm.sh
  55. -rw-r--r--   1 angus        1107 Nov 02  1995 includeres.man
  56. -rw-r--r--   1 angus        1435 Nov 02  1995 includeres.pl
  57. -rw-r--r--   1 angus        1901 Jan 03  1996 maketext
  58. -rw-r--r--   1 angus       31406 Jun 19  1995 md68_0.ps
  59. -rw-r--r--   1 angus       35734 Jun 19  1995 md71_0.ps
  60. -rw-r--r--   1 angus         132 Nov 02  1995 patchlev.h
  61. -rw-r--r--   1 angus        2875 Nov 02  1995 psbook.c
  62. -rw-r--r--   1 angus        1156 Nov 02  1995 psbook.man
  63. -rw-r--r--   1 angus        3201 Nov 02  1995 pserror.c
  64. -rw-r--r--   1 angus         561 Nov 02  1995 pserror.h
  65. -rw-r--r--   1 angus         957 Nov 02  1995 psmerge.man
  66. -rw-r--r--   1 angus        2028 Nov 02  1995 psmerge.pl
  67. -rw-r--r--   1 angus       10396 Nov 02  1995 psnup.c
  68. -rw-r--r--   1 angus        4002 Nov 02  1995 psnup.man
  69. -rw-r--r--   1 angus        5379 Nov 02  1995 psresize.c
  70. -rw-r--r--   1 angus        1696 Nov 02  1995 psresize.man
  71. -rw-r--r--   1 angus        6096 Jun 05  1996 psselect.c
  72. -rw-r--r--   1 angus        2117 Mar 09 09:12 psselect.man
  73. -rw-r--r--   1 angus        7784 Dec 06  1995 psspec.c
  74. -rw-r--r--   1 angus         877 Feb 21  1996 psspec.h
  75. -rw-r--r--   1 angus        5159 Nov 02  1995 pstops.c
  76. -rw-r--r--   1 angus        4091 Nov 02  1995 pstops.man
  77. -rw-r--r--   1 angus        9323 Mar 04 13:41 psutil.c
  78. -rw-r--r--   1 angus        1494 Nov 02  1995 psutil.h
  79. -rwxr-xr-x   1 angus        2685 Jun 19  1995 showchar.sh
  80.  
  81.  
  82. PROGRAMS
  83.  
  84. psbook          rearranges pages into signatures
  85. psselect        selects pages and page ranges
  86. pstops          performs general page rearrangement and selection
  87. psnup           put multiple pages per physical sheet of paper
  88. psresize        alter document paper size
  89. epsffit         fits an EPSF file to a given bounding box
  90.  
  91. psselect in modeled after Chris Torek's dviselect program, and pstops is
  92. modeled after Tom Rokicki's dvidvi program. psbook is modeled on my own
  93. dvibook program, which borrows heavily from Chris Torek's dviselect.
  94.  
  95. SCRIPTS
  96.  
  97. getafm   (sh)   outputs PostScript to retrieve AFM file from printer
  98. showchar (sh)   outputs PostScript to draw a character with metric info
  99. fixdlsrps (perl) filter to fix DviLaser/PS output so that PSUtils works
  100. fixfmps  (perl) filter to fix framemaker documents so that psselect etc. work
  101. fixmacps (perl) filter to fix Macintosh documents with saner version of md
  102. fixpsditps (perl) filter to fix Transcript psdit documents to work with PSUtils
  103. fixpspps (perl) filter to fix PSPrint PostScript so that psselect etc. work
  104. fixscribeps (perl) filter to fix Scribe PostScript so that psselect etc. work
  105. fixtpps  (perl) filter to fix Troff Tpscript documents
  106. fixwfwps (perl) filter to fix Word for Windows documents for PSUtils
  107. fixwpps  (perl) filter to fix WordPerfect documents for PSUtils
  108. fixwwps  (perl) filter to fix Windows Write documents for PSUtils
  109. extractres (perl) filter to extract resources from PostScript files
  110. includeres (perl) filter to include resources into PostScript files
  111. psmerge (perl) hack script to merge multiple PostScript files
  112.  
  113. INSTALLATION
  114.  
  115. UUdecode md71_0.uue and md68_0.uue (if supplied encoded). Copy the most
  116. appropriate makefile to "Makefile", and edit the copy to put in required paths
  117. for BINDIR, SCRIPTDIR, MANDIR, INCLUDEDIR, and PERL. Alter values of MANEXT to
  118. put the manual pages in a different section if desired, change PAPER to set
  119. the default paper size, "make", and "make install".
  120.  
  121. BUGS
  122.  
  123. The utilities don't check for PS-Adobe-?.? conformance; they assume documents
  124. conform. Utilities need an extra save/restore around whole document on a
  125. SPARCPrinter with NeWSPrint 1.0, because of bugs in the xnews server.
  126.  
  127. Bug fixes and suggestions to angus@harlequin.co.uk
  128.  
  129. UPDATES
  130.  
  131. The definitive archive sites for PSUtils updates are ftp.dcs.ed.ac.uk, in the
  132. directory pub/ajcd/, and ftp.tardis.ed.ac.uk, in the directory users/ajcd. The
  133. latest version will be in psutils.tar.gz older versions may also be in
  134. psutils-*.tar.gz
  135.  
  136. NOTE
  137.  
  138. This is an interim release; these utilities are currently being re-written
  139. from scratch, with a full DSC-3.0 parser and more extraction, merging, and
  140. inclusion options included.
  141.  
  142. WINDOWS USERS
  143.  
  144. *Please* make sure that you have selected "Generate DSC Comments" in your
  145. printer driver setup. These utilities need DSC comments to tell where page
  146. boundaries are.
  147.  
  148. DVIPS USERS
  149.  
  150. The latest versions of dvips have changed the default setting of the DSC
  151. comment flag; you must generate with DSC comments for PSUtils to work.
  152.  
  153. ACKNOWLEDGEMENTS
  154.  
  155. Bug fixes and suggestions for improvements to PSUtils have come from many
  156. people, including:
  157.  
  158.         Brian Colfer            brianc@labmed.ucsf.edu
  159.         Charles A. Finnell      finnell@org.mitre.lear
  160.         Conrad Kimball          cek@com.boeing.sdc
  161.         J.W.Hawtin              
  162.         Jochen Schwarze         schwarze@de.isa
  163.         Ken Carpenter           khc@edu.ksu.eece
  164.         Kristian Jorg           etxkrjg@se.ericsson.solsta
  165.         Larry Weissman          larryw@nsr.bioeng.washington.edu 
  166.         Michael L. Brown        brown@wi.extrel.com
  167.         Hunter Goatley            goathunter@wkuvx1.bitnet
  168.         John Interrante         interran@uluru.Stanford.edu
  169.         Maurizio Cremonesi      MAUCREM@imiclvx.earn
  170.         Matthew Stier           Matthew.Stier@East.Sun.com
  171.         Gerry Pratt             cca13@seq1.kl.ac.uk
  172.         Robert Joop             rj@rainbow.in-berlin.de
  173.     Johan Vromans        jv@mh.nl
  174.     Bryan Faubion        bryanf@tc.fluke.com
  175.     Chris Ritson        C.R.Ritson@ncl.ac.uk
  176.     Michele Marziani    MARZIANI@VAXFE.INFN.IT
  177.     Michael I. Schwartz    mschwart@diana.cair.du.edu
  178.     Chris Ritson        C.R.Ritson@newcastle.ac.uk
  179.     Joerg Eisenreich
  180.     Anreas Borchert        borchert@mathematik.uni-ulm.de
  181.     Mike Coleman
  182.     Dale Scheetz        dwarf@polaris.net
  183.     Yves Arrouye        arrouye@marin.fdn.fr
  184.  
  185. (Apologies to anyone who I have left out, it was not intentional.)
  186.  
  187. NEWS
  188.  
  189. Patchlevel 11 contains some significant enhancements to PSUtils, in
  190. preparation for the eventual release of version 2 (don't hold your breath
  191. waiting for it). These include:
  192.  
  193. * Specify paper sizes by name for pstops and psnup.
  194. * Psnup re-written in C to be much more versatile (do any number n-up).
  195. * Epsffit can input broken %%BoundingBox comments which use real numbers.
  196. * Should work on MSDOS and VMS machines as well as Unix.
  197. * Accept more DSC compliant documents (Page labels are better supported).
  198.  
  199. Patchlevel 12 was a bug-fix release.
  200.  
  201. * Long standing fixmacps bug fixed.
  202. * fixwfwps fixes WFW EPSF files as well as DSC files.
  203. * md71_0.ps and md68_0.ps files were automatically uudecoded.
  204.  
  205. Patchlevel 13 contained two new scripts for resource management, and fixes to
  206. the Makefile, page labels, and output chaining.
  207.  
  208. * Epsffit can output to a file as well as standard output.
  209. * extractres takes resources out of PostScript files and saves them
  210. * includeres puts resources from a resource library into PostScript files.
  211. * maketext script is now used to do substitutions in Perl scripts and man pages
  212. * page labels in psnup and pstops now show where pages came from.
  213. * page labels in psbook and psselect fixed.
  214. * prologues fixed to be extractable and re-usable
  215. * Makefile doesn't use SUFFIXES any more
  216. * pstops and psnup output can now be chained through each other.
  217. * psresize alters the paper size used by a document
  218. * patchlevel.h shortened to patchlev.h as a concession to MSDOS
  219. * psnup now has -n nup form for compatibility with other n-up programs
  220.  
  221. Patchlevel 14 has some minor bug fixes.
  222.  
  223. * psselect can take end-relative page ranges
  224. * Makefiles restructured to generate machine specific versions from one source
  225. * MSDOS, Windows NT and OS/2 support
  226. * corrections to psbook output for empty pages when rearranging pstops output
  227.  
  228. Patchlevel 15 was a stabilisation release
  229.  
  230. * All code converted to ANSI C, improved error and warning procedures
  231. * Portability fixes in the Makefiles
  232. * psnup can take different sized input and output pages
  233. * Minor fixes to fixwpps script
  234. * psselect reversed pages fixed
  235. * maketext and fix scripts updated for Perl 5
  236.  
  237. Patchlevel 16 was a minor bugfix release
  238.  
  239. * Piped output and input works correctly in NT
  240.  
  241. Patchlevel 17 had some minor bugfixes and improvements
  242.  
  243. * Trailer information now put before %%EOF comments if no %%Trailer
  244. * psselect can now add blank pages.
  245. * Piped input works in Linux
  246.